SOS_ENV
Die Umgebung für Entladescripte aus SOS
(Auszug)

##Pfad für Entladedaten:

SOS_PFAD=.   ; export SOS_PFAD 

##hier muss Unterverzeichnis unl existieren!

#ab hier werden Daten ausgewertet:

start_stud_sem = 19881 #sos-studenten und fächer

start_pruef_sem = 19921 #Prüfungen    

SOS_UNL_COMPLETE=true

export SOS_UNL_COMPLETE

Nur für Informix gelten:

INFORMIXDIR

Home-Verzeichnis von Informix

INFORMIXSERVER

Name des Informixservers

ONCONFIG

Name der onconfig, wenn  auf dem SOS-Rechner mehrere Informix-Instanzen laufen

CLIENT_LOCALE

Sprachumgebung (wichtig fürs Entladen von Datumsformaten)

SERVER_LOCALE

dito

Nur für Postgres gelten:

PGDATESTYLE

Datumsformat "German"

PGPORT

Port vom Postgres-Server, standardmäßig 5432

PGHOST

Hostname oder IP-Adresse vom Postgres-Server

PGUSER

Benutzerkennung für Postgres-Server (nur Datenbank, nicht Betriebssystem)

PGPATH

Installationsverzeichnis von Postgres, z.B. /usr/local/pgsql

DB_PROPERTIES

Pfad zur db-sos.properties-Datei mit den Zugangsparametern für SOSPOS unter Postgres

LOGGING_PROPERTIES

Pfad zur Steuerungsdatei mit den Parametern für das Logging beim Entladen, voreingestellt auf ./logging.properties. Normalerweise brauchen Sie hier nichts ändern, wenn beim Entladen Probleme auftauchen, kann man den Level von SEVERE auf INFO oder FINEST ändern, dann werden die konkreten SQLs geloggt. Aber Achtung: wenn keine Fehler mehr auftreten, müssen Sie den Level wieder auf SERVERE ändern, sonst kommen Schlüsselworte in die Logdatei sos_unload.err, die dann bei der Übernahme nach SuperX fälschlicherweise zu Fehlermeldungen führen.

Für alle Platformen gelten folgende Variablen:

SX_CLIENT

Entladeprogramm für SOSPOS-DB: dbaccess, psql oder jdbc

DATABASE

Entladedatenbank der SOSPOS-DB: INFORMIX, POSTGRES, ACCESS

VERSION

Version von HISSOS (Ganzzahlig)

start_stud_sem

Beginn des Semesters, ab dem aus stg/sos entladen wird (Studierenden- und Fächersätze)

start_pruef_sem

Beginn des Semesters, ab dem aus lab/lsem entladen wird (Prüfungssätze)

SOS_UNL_COMPLETE

Sollen soll immer alles entladen werden (true). False bedeutet, dass nur die jeweils am Vortag geänderten Sätze entladen werden (inkrementelles Entladen). Dieser Schalter ist wichtig für die Übernahme: In SOS archivierte Sätze bleiben in SuperX erhalten, wenn inkrementell entladen wird. Wenn immer aus SOS komplett entladen wird, und die Archivierung in SuperX-SOS nicht aktiviert ist, dann werden alle Datenbestände in SuperX ausgetauscht, d.h in SOS gelöschte oder archivierte Sätze werden auch in SuperX gelöscht.
Generell ist es sicherer, immer komplett zu entladen. Der Update auf SuperX-Seite dauert allerdings dann auch länger.

TRANSACTION_OFF

Nur für Informix und bei Entladen mit "SOS_UNL_COMPLETE=false": Wenn Transaktionen eingeschaltet sind und die Protokoll-Tabellen groß sind, dann sollte dieses wie folgt belegt sein.
TRANSACTION_OFF="SET ISOLATION TO DIRTY READ;"

SOS_UNL_ANON

Namen werden sowieso nicht aus SOS entladen, aber sollen auch die Daten bzgl. matrikelnr anonymisiert werden? ('true'/'false')

Wenn Sie 'true' wählen, werden in der Zusatztabelle mtknr_lsdg Matrikelnummern eindeutig gefüllt

POS_PNR

Welche Prüfungsnummern außer denen die in der Tabelle hskonst in SOS für Hauptdiplom, Vordiplom und sonstige Prüfungsnummern verzeichnet sind, sollen ebenfalls entladen werden? Setzen Sie hier eine "0", dann werden alle Prüfungen entladen (Vorsicht: viele Daten!).
Sie können auch weitere PNRs als Vor- oder Hauptprüfung deklarieren.
Ein Beispiel für weitere Prüfungen wäre z.B.:
POS_PNR='9390,9490,9690,9700'

LAB_FILTER

Zusätzliche Filter für Einzelprüfungen (SQL-where Bedingung). Standardmäßig werden anerkannte Prüfungen gefiltert mit dem Ausdruck:
AND (lab.panerk is null or lab.panerk != 'J')
Sie können diesen Filter erweitern oder entfernen (Achtung: SQL-Syntax beachten).

ERRORMAIL

An wen solle eine Logmail verschickt werden, wenn das Entladen nicht geklappt hat? (nur Unix).

LOGMAIL

An wen soll immer eine Logmail verschickt werden

MAILPROG

Pfad zum ausführbaren Mailprogramm unter Unix, Vorbelegung ist "mail", manche Unixe haben aber auch "mutt".

Wenn die Rohdaten nach dem Entladen vom SOS-Rechner auf den SuperX-Rechner kopiert werden sollen, dann werden für das Script sos_copy.x folgende Umgebungsvariablen benötigt:

COPY_METHOD

Programm, das die Dateien kopiert; rsync und scp sind wählbar.

REMOTE_DIR

Verzeichnis, in das die Rohdaten auf dem SuperX-Rechner kopiert warden sollen, in der Regel ist dies "/home/superx/db/module/sos/rohdaten"

REMOTE_USER

Der Unix-Username auf dem SuperX-Rechner, in der Regel "superx".

REMOTE_HOST

Der Rechnername bzw. die IP-Nr. des SuperX-Rechners.

Manuelles Anlegen der Pseudonymisierungstabelle

create table mtknr_ldsg

(

mtknr integer,

mtknr_ldsg serial

);

create unique index i_mtknr_1 on mtknr_ldsg (mtknr);